###User Defined Function###
_WinAPI_CreateEnhMetaFile

###Description###
Erzeugt einen Gerätekontext für eine Metadatei mit einem verbesserten Format.

###Syntax###
#include <WinAPIGdi.au3>
_WinAPI_CreateEnhMetaFile ( [$hDC = 0 [, $tRECT = 0 [, $bPixels = False [, $sFilePath = '' [, $sDescription = '']]]]] )

###Parameters###
@@ParamTable@@
$hDC
	[optional] Das Handle zum Referenzgerät für die verbesserte Metadatei. Das System nutzt diesen Gerätekontext um die Auflösung und Einheiten des Geräts aufzuzeichnen in welchen das Bild originalerweise erschien.hich a picture originally appeared.
	Wenn dieser Parameter 0 ist (Standard), so wird das aktuelle Anzeigegerät als Referenz verwendet.
$tRECT
	[optional] Die $tagRECT Struktur welches die Dimensionen des Bildes angibt welches in der verbesserten Metadatei gespeichert werden sollen.
	Wenn dieser Parameter 0 ist (Standard), so berechnet die Schnittstelle des Grafikgeräts das kleinstmögliche Rechteck welches noch das, von der Anwendung gezeichnete, Bild umschließt.
$bPixels
	[optional] Gibt an, ob die $tRECT Struktur in Pixeln definiert ist. Gültige Werte sind:
		True	- In logischen Einheiten (Pixeln).
		False	- In .01-millimeter Einheiten (Standard).
$sFilePath
	[optional] Der Dateiname der zu erstellenden verbesserten Metadatei.
	Wenn dieser Parameter '' ist (Standard), so ist die Metadatei speicherbasiert und ihr Inhalt geht verloren wenn sie durch die <a href="_WinAPI_DeleteEnhMetaFile.htm">_WinAPI_DeleteEnhMetaFile()</a> Funktion gelöscht wird.
$sDescription
	[optional] Der String welches den Namen der Anwendung angibt welche das Bild erstellt hat sowie den Titel des Bildes. Dieser String muss entweder leer sein oder diesem Format folgen:
		"Anwendungsname|Bildname"
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	Das Handle zu einem Gerätekontext für die verbesserte Metadatei.
Fehler:	0.
@@End@@

###Remarks###
Anwendungen verwenden den Gerätekontext, welcher von dieser Funktion erstellt wird, um Grafikbilder in der verbesserten Metadatei zu speichern.
Das Handle, welches den Gerätekontext identifiziert, kann jeder GDI-Funktion übergeben werden.

Nachdem eine Anwendung ein Bild in der verbesserten Metadatei speichert, kann es das Bild auf jedem Ausgabegerät mit dem Aufruf der <a href="_WinAPI_PlayEnhMetaFile.htm">_WinAPI_PlayEnhMetaFile()</a> Funktion anzeigen.
Wenn das Bild angezeigt wird, so verwendet das System das Rechteck, auf welches der $tRECT Parameter zeigt, und die Auflösungsdaten vom Referenzgerät um das Bild zu positionieren und zu skalieren.

Der Dateiname für die verbesserte Metadatei sollte die .emf Endung verwenden.

###Related###
_WinAPI_PlayEnhMetaFile

###See Also###
@@MsdnLink@@ CreateEnhMetaFile

###Example###
@@IncludeExample@@
